home *** CD-ROM | disk | FTP | other *** search
/ Skunkware 5 / Skunkware 5.iso / man / cat.n / array.n < prev    next >
Text File  |  1995-07-25  |  6KB  |  133 lines
  1.  
  2.  
  3.  
  4.      aaaarrrrrrrraaaayyyy((((nnnn))))                     TTTTccccllll (((( ))))                     aaaarrrrrrrraaaayyyy((((nnnn))))
  5.  
  6.  
  7.  
  8.      _________________________________________________________________
  9.  
  10.      NNNNAAAAMMMMEEEE
  11.           array - Manipulate array variables
  12.  
  13.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  14.           aaaarrrrrrrraaaayyyy _o_p_t_i_o_n _a_r_r_a_y_N_a_m_e ?_a_r_g _a_r_g ...?
  15.      _________________________________________________________________
  16.  
  17.  
  18.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  19.           This command performs  one  of  several  operations  on  the
  20.           variable  given by _a_r_r_a_y_N_a_m_e.  _A_r_r_a_y_N_a_m_e must be the name of
  21.           an existing array variable.  The _o_p_t_i_o_n argument  determines
  22.           what  action  is  carried  out  by  the  command.  The legal
  23.           _o_p_t_i_o_n_s (which may be abbreviated) are:
  24.  
  25.           aaaarrrrrrrraaaayyyy aaaannnnyyyymmmmoooorrrreeee _a_r_r_a_y_N_a_m_e _s_e_a_r_c_h_I_d
  26.                Returns 1 if there are any more  elements  left  to  be
  27.                processed  in  an  array search, 0 if all elements have
  28.                already been returned.  _S_e_a_r_c_h_I_d indicates which search
  29.                on  _a_r_r_a_y_N_a_m_e  to  check, and must have been the return
  30.                value from a previous invocation of aaaarrrrrrrraaaayyyy  ssssttttaaaarrrrttttsssseeeeaaaarrrrcccchhhh.
  31.                This  option  is particularly useful if an array has an
  32.                element with an empty name, since the return value from
  33.                aaaarrrrrrrraaaayyyy nnnneeeexxxxtttteeeelllleeeemmmmeeeennnntttt won't indicate whether the search has
  34.                been completed.
  35.  
  36.           aaaarrrrrrrraaaayyyy ddddoooonnnneeeesssseeeeaaaarrrrcccchhhh _a_r_r_a_y_N_a_m_e _s_e_a_r_c_h_I_d
  37.                This command terminates an array  search  and  destroys
  38.                all  the  state  associated with that search.  _S_e_a_r_c_h_I_d
  39.                indicates which search on  _a_r_r_a_y_N_a_m_e  to  destroy,  and
  40.                must  have  been  the  return  value  from  a  previous
  41.                invocation of  aaaarrrrrrrraaaayyyy  ssssttttaaaarrrrttttsssseeeeaaaarrrrcccchhhh.   Returns  an  empty
  42.                string.
  43.  
  44.           aaaarrrrrrrraaaayyyy nnnnaaaammmmeeeessss _a_r_r_a_y_N_a_m_e
  45.                Returns a list containing  the  names  of  all  of  the
  46.                elements in the array.  If there are no elements in the
  47.                array then an empty string is returned.
  48.  
  49.           aaaarrrrrrrraaaayyyy nnnneeeexxxxtttteeeelllleeeemmmmeeeennnntttt _a_r_r_a_y_N_a_m_e _s_e_a_r_c_h_I_d
  50.                Returns the name of the next element in  _a_r_r_a_y_N_a_m_e,  or
  51.                an  empty  string  if  all  elements  of _a_r_r_a_y_N_a_m_e have
  52.                already been returned in  this  search.   The  _s_e_a_r_c_h_I_d
  53.                argument  identifies the search, and must have been the
  54.                return value of an aaaarrrrrrrraaaayyyy ssssttttaaaarrrrttttsssseeeeaaaarrrrcccchhhh command.  Warning:
  55.                if  elements  are  added  to or deleted from the array,
  56.                then all searches are automatically terminated just  as
  57.                if  aaaarrrrrrrraaaayyyy  ddddoooonnnneeeesssseeeeaaaarrrrcccchhhh had been invoked; this will cause
  58.                aaaarrrrrrrraaaayyyy  nnnneeeexxxxtttteeeelllleeeemmmmeeeennnntttt  operations  to   fail   for   those
  59.                searches.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 7/17/95)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      aaaarrrrrrrraaaayyyy((((nnnn))))                     TTTTccccllll (((( ))))                     aaaarrrrrrrraaaayyyy((((nnnn))))
  71.  
  72.  
  73.  
  74.           aaaarrrrrrrraaaayyyy ssssiiiizzzzeeee _a_r_r_a_y_N_a_m_e
  75.                Returns a decimal string giving the number of  elements
  76.                in the array.
  77.  
  78.           aaaarrrrrrrraaaayyyy ssssttttaaaarrrrttttsssseeeeaaaarrrrcccchhhh _a_r_r_a_y_N_a_m_e
  79.                This command initializes an  element-by-element  search
  80.                through   the  array  given  by  _a_r_r_a_y_N_a_m_e,  such  that
  81.                invocations  of  the  aaaarrrrrrrraaaayyyy  nnnneeeexxxxtttteeeelllleeeemmmmeeeennnntttt  command  will
  82.                return  the  names  of  the  individual elements in the
  83.                array.  When the search has been completed,  the  aaaarrrrrrrraaaayyyy
  84.                ddddoooonnnneeeesssseeeeaaaarrrrcccchhhh command should be invoked.  The return value
  85.                is a search identifier  that  must  be  used  in  aaaarrrrrrrraaaayyyy
  86.                nnnneeeexxxxtttteeeelllleeeemmmmeeeennnntttt  and  aaaarrrrrrrraaaayyyy  ddddoooonnnneeeesssseeeeaaaarrrrcccchhhh commands; it allows
  87.                multiple searches to be underway simultaneously for the
  88.                same array.
  89.  
  90.  
  91.      KKKKEEEEYYYYWWWWOOOORRRRDDDDSSSS
  92.           array, element names, search
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 7/17/95)
  130.  
  131.  
  132.  
  133.